____________________________________________________________________

To change the maximum number of resources for one ISaGRAF project, you can add / modify some startup configuration parameters.

This is done in different ways according to the target platform. For example, under NT this is done using entries defined in ini files.

Refer to the FAQ: "Startup Parameters" for more information on startup configuration parameters.

See at end of this FAQ, settings for Windows NT, OS9 and VxWorks.

Max Number of resources restriction areas:

• Workbench debugger for all configurations:

• IXL connections
  The debugger opens 2 connections per resource, plus one for the configuration manager (CMG-ISaGRAF).
  IXL library is limited.
  By default to 16 connections if there is no entry in dta.ini file in version 4.03, and by default since V4.04 CnxNbr is: 102 => 33 resources).
  TO INCREASE this limitation you can modify in <workbench-directory>\bin\DTA.INI file in the [IXL] section the 'CnxNbr' parameter setting the required value.

• ETCP number of channels (ChNbr).
  ETCP open 4 channels per resource, plus 4 the CHM (NbResources+1)*4.
  Modify startup parameters 'ChNbr' with the required value (default=50=>11 resources).

If this option is missing or "ChNbr"" is incorrect, the following error appears:
* In DPM output window: "Error occured during the connection to resource. DTA Server system error 20000411."
* In DPM_SRV console application window:
[-1 20000411]
-1: DTA Server system error.
411: CRU: Channel table full

• Target hardware configurations (including simulator):

• Configuration Manager (ISAGRAF):Maximum of resources launched by configuration manager (CMG):

• The CMG launches a limited number of resources (default=16).

  Modify startup parameter 'ResNbr' with the maximum desired number of resources to launch (in ISaGRAF.ini in the case of the NT target, in section [APP]).

If this option is missing or "ResNbr" is not correct, following errors appear:
* In DPM output window: "Error occured during the connection to resource. Request has failed."
* In DTA_SRV console application window:
[-50 2000053F]
-50: Request has failed.
53F: IXL: Kernel problem in executing request.

• IXL Connections from exchange dispatcher (IXD) to resources.
  IXD opens one connection per resource. (NbResources)
  Modify startup parameter 'CnxNbr' with the required value.
  (default value=16 resources)(In ISaGRAF.ini for the NT target,in section [IXL]).

If this option is missing or "CnxNbr" is not correct, following errors appear:
* In DPM output window: "Error occured during the connection to resource. Transport failed in ISaIXD."
* In DTA_SRV console application window:
[-16 20000539]
-16: ISaIXD: Transport failed in ISaIXD.
539: IXL: Cannot establish connection, maximum connection is reached.

• IXS Connections from IXL clients to to resources and to CMG.
  Workbench opens two connections per resource plus two for the configuration manager. (NbResources + 1)*2 + NbDrivers.
  Modify startup parameter 'CnxNbr' with the required value.
  (default value 8 resources + 4 drivers)(In ISaGRAF.ini for the NT target,in section [IXS]).

If this option is missing or "CnxNbr" is incorrect, following errors appear:
* In output window of the DPM: "Error occured during the connection to resource. NET: Network Transport failed."
* In DTA_SRV console application window:
[-32 20000521]
-32: NET: Network Transport failed.
"521: ISXS: Cannot establish connection, no more free IXS connection available."

• Maximum number of Channels in exchange dispatcher (IXD), 'ChNbr', must be set with (NbResources + 1)*2.
  (default value=> 8 resources). (In ISaGRAF.ini for the NT target, in section [IXD]).

If this option is missing or "ChNbr" is not correct, following errors appear:
* In DPM output window:"Error occured during the connection to resource. A time-out occurs during connection."
* In DTA_SRV console application window:
[-16 20000513]
-16: ISaIXD: Transport failed in ISaIXD.
513: ISXL: Start dialog has failed.

____________________________________________________________________

Settings for the ISaGRAF Workbench (if you wish to launch 20 resources):

· Add in DTA.ini file, in [IXL] section, CnxNbr=42. ((20 resources +1 for CMG)*2)

· Add in ETCP.ini file, in [APP] section, ChNbr=84. ((20 resource +1 ) *4)

____________________________________________________________________

Settings for the ISaGRAF NT target or the simulator (if you wish to launch 20 resources):

· Add in ISAGRAF.ini file:

in section [APP], ResNbr = 20. This is to allow the configuration manager to launch 20 virtual machines.
in [IXL] section with CnxNbr=21. ((20 resources +1 for the CMG))
in [IXS] section with CnxNbr=46. ((20 resources +1 for CMG )*2) + 4 drivers
in [IXD] section with ChNbr=42. ((20 resources +1)*2)

____________________________________________________________________

Settings for the ISaGRAF VxWorks target (if you wish to launch 20 resources):

For VxWorks you have to use the putEnv command.

• First give a name to the configuration manager task:

As under VxWorks, by default the configuration manager has no taskname if you launch it with standard script, you have to modify ISaGRAF.spt script as follows:

sp dcmgMain ==> TO BE REPLACED WITH
taskSpawn ("ISAGRAF", 100, VX_FP_TASK, 20000, dcmgMain, 0, 0, 0,0,0,0,0,0,0,0)
# NOTE:
# Parameters used with taskSpawn( ) are same as default one used with sp( )
# They may need to be adapted
### Use Serial link only, for workbench debugging
#argv = "-RSI=/tyCo/1:19200 -NoETCP"
#argc = 1
#sp (dcmgMain, argc, &argv) ==> TO BE REPLACED WITH
taskSpawn ("ISAGRAF", 100, VX_FP_TASK, 20000, dcmgMain, argc, &argv, 0,0,0,0,0,0,0,0)
# NOTE:
# Parameters used with taskSpawn( ) are same as default one used with sp( )
# They may need to be adapted

• To allow the configuration manager to launch 20 virtual machines
  putEnv("ISAGRAF_RESNBR=20")

• ISaIXD:
  putEnv("ISAIXD_IXL_CNXNBR=21")((20 resources +1 for the CMG))
  putEnv("ISAIXD_IXS_CNXNBR=42")((20 resources +1 for CMG )*2)
  putEnv("ISAIXD_CHNBR=42")((20 resources+1)*2)

____________________________________________________________________

Settings for the ISaGRAF OS9 target (if you wish to launch 20 resources):

Idem VxWork with the command setenv instead of putEnv.

____________________________________________________________________

Copyright © 1999-2009 ICS Triplex ISaGRAF Inc. All rights reserved.